home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 2301_400 / DISK2342 / DISK2342.ZIP / HOST.COM / HOST.DOC < prev    next >
Text File  |  1990-05-25  |  8KB  |  239 lines
  1.  
  2.                        Telemate Host mode
  3.  
  4.                           By  Tsung Hu
  5.  
  6.                           22 May, 1990
  7.  
  8.  
  9. Introduction
  10.  
  11. Telemate host mode is written with its script language and can
  12. be modified freely with no royalty.  In Telemate Version 2.1, there
  13. are many useful commands, such as file and string handling, which
  14. make the host script easier to be written.
  15.  
  16. The following are the host-related files:
  17.  
  18.  
  19.   HCONFIG.SCR  - Host configuration script
  20.   HCONFIG.TMS  - Compiled script, C>TMS HCONFIG
  21.   HOST.SCR     - Host mode script
  22.   HOST.TMS     - Compiled script, C>TMS HOST
  23.  
  24.   HCONFIG.HST  - Configuration file  (created after first run)
  25.   HUSER.HST    - User information   (created after first run)
  26.   HWELCOME.HST - Welcome message
  27.   HNOTICE.HST  - Notice or bulletin
  28.   HMENU.HST    - Main menu
  29.   HPROT.HST    - Protocol menu
  30.   BGOODBYE.HST - Goodbye message
  31.  
  32.   HSHELL.BAT   - [S]hell batch file  (created during configuration)
  33.   HLOCAL.BAT   - [R]un local program
  34.   HREMOTE.BAT  - [R]un remote program
  35.   HOST.DIR     - [F]ile directory file (run-time temporary file)
  36.  
  37.  
  38.  
  39. TO INSTALL THE HOST MODE
  40.  
  41. . Set the modem answer string to "~~~+++~~~AT S0=1^M" under the
  42.   Options/Communication dialog
  43.  
  44. . Run the HCONFIG.SCR by passing [Alt S].  HCONFIG will ask you which
  45.   COM port you are using.  If it is COM1 or COM2, it will generate
  46.   the HSHELL.BAT batch file with the following content,
  47.         CTTY COM1
  48.         COMMAND
  49.         CTTY CON
  50.         EXIT
  51.   supposed the modem is in COM1.  This batch file allows you to shell
  52.   to DOS with the [S]hell command.
  53.  
  54.   Then it will display the menu
  55.  
  56.         A: New user level     : 1
  57.         B: Sysop level        : 2
  58.         C: Detect baud rate   : ON
  59.         D: Initial baud rate  : 2400
  60.         E: Yell time          : 3 seconds
  61.         F: Yell sound         : 1 seconds
  62.         G: Host directory     : \TM
  63.         H: Download directory : \TM
  64.  
  65.         S: Save configuration and run host mode
  66.         Q: Abort configration
  67.  
  68.   Telemate's host is an open system, which mean new user can join
  69.   the system freely.  Each of them have his own password.  In current
  70.   implementatation, only two levels are used.  Level 2 can use the
  71.   [S]hell,  [R]un remote program and [Z] shut down commands while
  72.   level 1 cannot.
  73.  
  74.   Some modems can lock the COM port at a certain baud rate.  For example,
  75.   a 2400 baud MNP modem can lock at 4800 or 9600 baud with the "AT &B1"
  76.   command.  For these modems, the <Detect baud rate> option should be
  77.   turned off.
  78.  
  79.   <Initial baud rate> should be the highest possible baud rate of your
  80.   modem.
  81.  
  82.   <Yell time> and <Yell sound> are the amount of time, in second, that
  83.   the alarm appears and yells when the [C]hat command is issued.  To
  84.   disable the [C]hat command, you can set the <Yell time> to 0.
  85.  
  86.   <Host directory> is the directory containing all the H*.HST and H*.BAT
  87.   files, they  are the bulletin, the menu and the batch file for shelling
  88.   to DOS.
  89.  
  90.   <Download directory> is the host download directory.  The [F]ile, [T]ype
  91.   and [D]ownload commands can only access files in this directory.
  92.  
  93.   Note: Due Telemate script restriction, the [U]pload command always
  94.         upload files to the Telemate download directory.
  95.  
  96.   After setting up these parameters, you can press 'S' to save the
  97.   configuration and it will chain to the host script automatically.
  98.  
  99. . However, installation is not completed yet.  To make full use of the
  100.   host script, you should also modify the HSHELL.BAT, HLOCAL.BAT and
  101.   HREMOTE.BAT batch file.
  102.  
  103.   HSHELL.BAT will be executed when the [S]hell command is issued.
  104.   Although it is already created by the HCONFIG.SCR, the batch file
  105.   does not monitor carrier signal.  That means the computer will hang
  106.   up when the remote user drop carrier.  You should use a third-party
  107.   product such as WATCHDOG or DOORWAY for maximum security.
  108.   Note: In local mode, HOST will shell to DOS directly and will not
  109.   use this batch file.
  110.  
  111.   HREMOTE.BAT will be executed when the [R]un remote program command
  112.   is issued by a caller.  This program can be a game or an BBS editor.
  113.  
  114.   HLOCAL.BAT is similar to HREMOTE.BAT but it is executed when the [R]
  115.   command is issued in local mode.  You may use the same program but
  116.   different options or use a completely different program in this batch
  117.   file.
  118.  
  119.   Of course, you should customize your own welcome message and bulletin.
  120.   A warm welcome will make the user feel much better.  If you don't have
  121.   any bulletin, you may delete the HNOTICE.HST.
  122.  
  123.  
  124.  
  125. RUNNING THE HOST MODE
  126.  
  127. To run the HOST.SCR, you could press [Alt S] while you are in
  128. Telemate.  Or type
  129.         C>TM HOST
  130. while you are in DOS command line.
  131.  
  132. When the host mode begin, you could press
  133.         'L'     for local mode
  134.         'C'     for configuration (run HCONFIG.SCR)
  135.         [Esc]   to terminate host
  136.         [Alt H] to temrinate the user (hang up the phone)
  137.  
  138. When a call is encounter, the user will be asked for his name and
  139. password.  The name and password must be or longer than 4 characters.
  140. After that, the user can choose a command from the menu.
  141.  
  142. Most of the users should have experiences with different types of BBSs.
  143. But they all have the commands
  144.  
  145.         [F]ile directory
  146.         [U]pload a file
  147.         [D]ownload a file
  148.         [T]ype a file
  149.         [C]hat with sysop
  150.         [X]pert mode
  151.         [G]oodbye
  152.  
  153. The [F]ile command will shell to DOS and execute the DOS command
  154.         DIR >\HOST.DIR
  155. which store the file list into a file.  Then HOST.SCR will display the file.
  156. So don't worry when it shell to DOS, it is just a [F]ile command.
  157.  
  158. When the user issues the [C]hat command, the alarm will be pop-up.  Sysop
  159. should press
  160.         [Enter] to accept
  161.         [Esc] to deny
  162. If [Enter] is pressed, HOST.SCR will begin a chat mode.  The sysop should
  163. press [Esc] to terminate the chat mode.
  164.  
  165. There are three commands provided for sysop.  They are
  166.  
  167.         [S]hell to DOS
  168.         [R]un remote program
  169.         [Z] shut down
  170.  
  171. The [S]hell command will jump to DOS directly in local mode; and run
  172. the HSHELL.BAT to shell to DOS if it is a remote call.
  173.  
  174. The [R]un command will run HLOCAL.BAT in local mode; and run HREMOTE.BAT
  175. in remote mode.
  176.  
  177. The [Z] shut down command should be issued only if you don't need the host
  178. mode any more.  It will ask you 'Are you sure ?'.  If you said 'Y'es, the
  179. call will be disconnected and will not answer any more callers.
  180.  
  181.  
  182. FORMAT OF THE USER FILE   (HUSER.HST)
  183.  
  184. When a new user is encountered, his name, password and access level
  185. are stored in the file HUSER.HST.  The format is
  186.  
  187. first last;password#<level>
  188.  
  189. where <level> is 1 or 2.  For example, my record will look like
  190.  
  191. Tsung Hu;mypass#1
  192.  
  193. To raise a user's access level, you can use an editor to change the 1
  194. to 2.  After that, the record will look like
  195.  
  196. Tsung Hu;mypass#2
  197.  
  198. There may be several records in the file, they all have the same format.
  199.  
  200.  
  201. FURTHER IMPROVEMENT
  202.  
  203. There are a lot of space for improvements.  Here are a few suggestions:
  204.  
  205. . More access levels and different menu for different level.
  206.  
  207. . Usage log: If you would like to keep track of a user's activities,
  208.   you could add
  209.         USAGE "User attempts to shell to DOS"
  210.   etc.
  211.  
  212. . Inactive timeout: This can be done by
  213.         IF NOT LOCAL
  214.            WHENIDLE 600,"^*"
  215.         ENDIF
  216.   which send the modem hangup string if there is no activity through
  217.   the COM port in 10 minutes.
  218.  
  219. . Time limit: You may calcuate the connect time using the procedure
  220.   DIFFTIME in toolbox #3.
  221.  
  222. . ANSI graphics or full screen command: Toolbox #1 is a good start
  223.   for this attempt.
  224.  
  225. If you need any assistance, you can contact Winfred Hu at the Telemate
  226. support BBS's or the following network:
  227.  
  228.         SmartNet    Telemate conference
  229.         RelayNet    Telemate conference
  230.         WWIVnet     Telemate hotline
  231.         FidoEcho    National Telemate Echo
  232.         BIX         winfredhu
  233.         CompuServe  [72070,3515]
  234.         InterNet    72070.3515@compuserve.com
  235.  
  236.  
  237.                    ~~~~~   End of HOST.DOC   ~~~~~
  238.  
  239.